package com.tianji.promotion.service;

import com.tianji.common.domain.dto.PageDTO;
import com.tianji.promotion.domain.dto.CouponFormDTO;
import com.tianji.promotion.domain.dto.CouponIssueFormDTO;
import com.tianji.promotion.domain.po.Coupon;
import com.baomidou.mybatisplus.extension.service.IService;
import com.tianji.promotion.domain.po.UserCoupon;
import com.tianji.promotion.domain.query.CouponQuery;
import com.tianji.promotion.domain.vo.CouponPageVO;
import com.tianji.promotion.domain.vo.CouponVO;
import org.springframework.transaction.annotation.Transactional;

import javax.validation.Valid;
import java.util.List;

/**
 * <p>
 * 优惠券的规则信息 服务类
 * </p>
 *
 * @author 赵博凯
 * @since 2025-11-01
 */
public interface ICouponService extends IService<Coupon> {

    /**
     * 保存优惠券
     * @param couponFormDTO 优惠券表单数据
     */
    void saveCoupon(CouponFormDTO couponFormDTO);

    /**
     * 分页查询优惠券
     * @param query 查询条件
     * @return 优惠券列表
     */
    PageDTO<CouponPageVO> queryCouponByPage(CouponQuery query);

    /**
     * 开始发放优惠券
     * @param dto 优惠券发放表单数据
     */
    void beginIssue(@Valid CouponIssueFormDTO dto);

    /**
     * 暂停发放优惠券
     * @param id 优惠券id
     */

    void pauseIssue(Long id);



    /**
     * 查询发放中的优惠券
     * @return 优惠券列表
     */
    List<CouponVO> queryIssuingCoupons();
}